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GENERAL DESCRIPTION 


DMPALL is a generat media conversion program used to transfer 
files from one hardware r,sedium to another. It also can list 
fides from any medium with a byte» digit» or combined fora. 
Along with these abilities it can start or stop reading files at 
a specified record. Specifications may be passed to DMPALL fron 
either a consotie keyboard or a card readers» with the default mode 
as console keyboard CODT) input. Various program switches (see 
SWITCH SETTINGS) can atso be used to controt the type of execu- 
tion that the user desires. 


RELATED DOCUMENTATION 


B1i800/B1700 Systems Software Operational Guide #1068731 
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QGPERATING INSTRUCTIONS 


CONSOLE KEYBOARD INPUT 


DMPALL is normatty executed from the console keyboard. It is 
executed with an NCP execute string (EX DMPALL) and responds with 
the following: 


DMPALL 
DMPALL 


<job-number>ENTER SPECS 
<job-nusber >ACCEPT 


The operator replies to the accept message by entering a <job- 
mumber>AX <specification string> where <specification string> 
contains the specifications needed to perform the DMPALL opera- 


tion» and <job-number> refers to the unique job nuaber assigned 
by the MCP. A specification string is defined as the sequence of 
valid DMPALL commands» and their required parameters» that 


produces the type of ddta transfer the user desires- 


Entries are optionat when DMPALL can find the required informa- 
tion from another source (eege» disk file header of a disk file) 
or when the input itself indicates the type of processing (Ceege> 
CARD or CRD presumes an unblocked file). Iilegal specifications 
are reported as errors and an appropriate error message is 
displayed on the ODT. 
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Examples of Console Keyboard Inout 


A response of 

€jobrnumber>aX LIST PACKA/PAYROLL/ A SKIP 50 
causes a disk file identified as *PAYROLL” and located on the 
disk “PACKA®™ to be printed beginning with the fifty-first record. 
A response of 

<job-number>AX COPY CRDDSK CARD SOURCE 80 2 
causes a card file with the file-identifier "CARD*™ to be written 
to a disk file» S80-character records» blocked 2» with the file- 
identifier "SOURCE™. 
A response of 

<job-number>AX COPY PROGRAM/B CCC/PROGRAN/B 


causes a disk file "PROGRAM/B” tocated on a system disk to be 
copied to the disk "CCC" with the identifier "PROGRAN/B". 
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WITCH SETTINGS 


Nodifications of the switch settings change the zero value 
Cdefault) of the switch and alter the way DMPALL executes. These 
switches can be ‘permanently set Cmodified)» changed during 
program execution or specified at execution time before the spec~ 
ification string(s) are accepted. (See Software Operational 
Guide). a 


The default vatues of OMPALL"s program switches are: 


SWITCH VALUE RESULT 
O» 3 0 Specifications accepted only from the ODT 
1 0 Continue process until the end 
2 0 Nugsber of syntax errors encountered are not 
| ‘displayed at any time 
7 0 Continue with next specification 
8 0 Interpret card decks Chardware permitting) 
6» 9 0 Stop if an error is encountered on input files 


Fhese switches can be set with ‘the following values to produce 
the results described: 


~ 


“SWITCH VALUE RESULT 


0 1 Specifications accepted only from CARDS 

i i Terminate processing of current specifications 
proceed to next specification 

2 1 | Number of syntax errors encountered displayed 

a at EOJ time 

3 | Specifications accepted onty from CARDS 

6 i Ignore input file errors 

7 1 Stop DMPALL after completion of the next 
executed specification 

8 1 No interpretation of card decks desired 

9 1 Ignore input file errors 

NOTE: Switches 0 and 3 represent the same switch. If either 


switch (CO or 3) has a value of i» then both switches are consid- 
ered to be set. Switches 6 and 9 represent the same switche If 


either switch (6 or 9) has a value of i» then both switches are 


considered to be set. (Switches 3 and 6 have been ieplemented 
for use with Work Flow Language.) | 
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CARD INPUT 


When executed through a card reader (?EX DMPALL) with 3WO=L> 
DMPALL expects ail specifications to be entered from the card 
reader. | 


The DMPALL execute control deck has the following format: 


? EX DMPALL SWO=1> | 
? FE SPEC NAME <SPEC_FILE_IDENTIFIER>s COptionat Card) 
2? DATA <SPEC_FILE_IDENTIFIER> 
(Speci fication cards) 
2? END 


A specification string may span more than one card by using a 
hyphen with blanks around it. This means you have to took for 
the rest of the string on the next card. 


A semicolon with terminate the specification strings after which 
comments may be entered. There way be more than one card in a 
specification card file. : 


Ali specification entries are ' free form in up ‘to 96 columns of a 
card» and may be separated by either a’‘space or a commar or a 
combination thereof. The card file containing the specifications 
is loaded to disk» and each specification is executed in turn. 


Exagple of fard Input 


? EX DMPALL SWO=1> 

2? DATA. SPEC | 
COPY CRDDSK XXX 72 1 DSKFIL 890 & 
LIST DSKFIL A 


? DATA XXX 
(Card data deck) 
? END 


The specifications will cause the card file "XXX" to be loaded to 
disk» then Listed in alpha format. 
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PRINT SPECIFICATIONS 


The specification ‘string for printing a file is shown in the 
syntax diagram table’ 3.1 and explained in the pages that fotliow. 
A vatid DMPALL command is developed fron following the Wain line 
of syntax from its beginning to its termination point (#). Where 
optional entries are concerned» the direction of flow proceeds 
down on the leftchand line and up on the right. Unless otherwise 
noted» optional entries are expected by the program in the order 
Ctop to bottom) in which they are presented. A line that may 
onty be crossed once is shown by */1\". 


Required entries occur on the main Line of developments optional 
ones below that tine. Required keywords appear in upper-case 
letters; variables in lower-case letters. Underlined portions 
of required keywords are acceptabte abbreviations for the 
keywords. Abbreviations of variables that occur in tablie 3.1 are 
as follows: 7 


Variable Abbreviation 


operator 


identifier id 

record rec : 
number num 

position posn 

length leng 

ar guaent arg 


op 
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aT rT LIST NODES neaananaee <file-id> SO 88S S282 O88 2888 O88 88 B28 2e 22 2>)> 
1 =--- : ' | : 
fe- LESTA -->8 05 t-- HOST -- chostname> ->!1 


§m- LIST2 <->! 


{-/i\-- <inputwrec“leng> Fee ee eae awe anes een eoeesceceeee@) } 
! t-- <plocktinag-factor> err-=>] 
i i 
i-/1i\-- TAG: K<tag-file-id> Se eee nese nee Teae wees eoeseweew=) j 
l-Jit\-- <input~file-access-mode> Sen ee wav eewoecooees seeee@) } 
i-/i\-- <outputforsmat> eee ee Ceara eee eer eee ee ee oe ee eee 
$-7i\-- <hardware-t ype> Sees esse ees eee eae cease aeeooceoe ) } 
1-/a\-- SKIP <integer> See esa wane ese seca was aee ee asaecawecoeee=)» ] 
i | i 
i-7i\-- INCLUDE <integer> ow naa weeae sane wae woaneae coe een) | 


— { 

EW" SANS@ VARIAOLE HSPs eases ass eee Ses ees S 3 Hee See= sss" —s==>] 

i I- VARY ---=*>1 i 

I | ! 

i-/iNer" SEARCH “-- <start-posn> ---- <searchrarg> -*-7"">>! 

ee i | | nr | 
tm- SELECT --1 | 


i -— on = | { C{wweeweewoeceeecooecea |} { 


! 

_ | 
i-- EXCLUDE->! i-- <nuacto-return> -->! 1 
ee 
i-- KEY"> <start -posn> ster essresree---<key7op>- i I 
be--<ckeycleng>->1 { ! 
| i i 

' 
' 
i 


j-- <searcharg> SOQ ae Geneteen Qennanneanaanaeaaane > 


i-- <nuattorreturn> =->1 


Table 3.1 Print Specification String 
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The LIST» LST» LISTi or LSTL entry indicates a single-spaced 
 disting will be printeds LIST2 or LST2 specifies double-spaced. 


The <file-id> entry must immediately follow the LIST entry and is 
required for all files. The format of the <file-id> entry is the 
Same as used in WCP control instructions: from one to three 


identifiers separated by slashes. A fitlecridentifier that is 
entirely numeric or which contains special characters must be 


surrounded by quotes. (See 81800/B1700 Software Operational 


Guide for gore details.) 


<file-id> can consist of the following forms; 


€pack-id>/<aulti*fite-id>/ 
<pack~id>/<multi~file-id>/<tite-id> 
<pack~-id>/<fasily-name>/= 
<maulti-file-id>/ 
<nultic-file-id>/<fite-id> 
<family-nare>/= 


Use of the "=" following <aulti-file-id> will cause a list of ail 
files with the specified <family-name>. 


An optional hostname may be inctuded with the file-name» but may 
not be used when specifing "=" as file-identifier. 
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The Host entry specifies that the file resides on another systes 
and Host services must be present to access the file. 


The first numeric entry following the <file-id> must be the 
<inputwrec"ieng> in bytes Cmaxiaun tength: 4000 bytes for ASCII 
conversion or TAG: options and 8»000 bytes for ail other lists). 
If om@tted» an <input-rec-leng> of 80 and a <blocking-f actor> of 
one is assumed for att files except disk and tabeled tape files 
which (use the <inpatcrreccleng> and <biocking-factor> of the fite 
when created. The second numeric entry following the <fite-id> 
must be the <btocking-factor>. If omitted and an <input-rec- 
leng> entry is presents then an unblocked file its assumed. 


The TAG: <tag-filecid> entry may be used to specify the use of a 
tag file for indexing into the input file. The tag file must be 
created with the CO80L68 or RPG. naming conventions (see _ the 
COBOL6S or RPG reference manuals). | 


The <input-file-access-mode> entry may be one of the following 
Cincluding quotation marks): | 7 


le ASCII files: "ASCII" 

2e BCL files: *BCL*™ 

3-2 BINARY files: "*BINARY® 

4. EBCDIC files: "EBCDIC* CIf this entry is omitted» “"EBCDIC* 
1s assumed as the default.) 


If the input file is a tLabeled tape» the access mode will be that 
with which the file was created. 


The <output~“format> entry may be specified as: 


1. Alphanumeric: A or ALFA. 

2e WNumeric: Ns» NUM» H» or HEX. 
Cif this entry is omitted» atphanuseritc ts assumed as the 
default) | 


3-5 


BURRBUGHS CORPORATION CONPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP — "B18007B1700 DMPALL 
SANTA BARBARA PLANT “PeSe 2212 5116 CH) 


The <hardware-type> entry may be one of the foitowing: 


4. Card files: CRD or CARD 

Ze Y96-coel. Card files: C96 or CARDI6 

3. Magnetic Tape files: MTP or TAPE 

&. Paper Tape filess PPT or PAPER 

Se Disk files: DSK or DISK CAssumed if <hardware-type> omitted) 
6-2 Y-Track Tape files: MT7 or TAPE7 

T- %M-Track Tape files: MI9 or TAPES 

8. Cassette Tape files: CAS or CASS 

9. Binary Card filles BIN or BINARY 
10. Multipack Disk files: MPF or MULTI 


The SKIP <integer> entry may be entered to begin printing after a 
specified number of records as denoted by the <integer>. 


The INCLUDE Cor INCL) <integer> entry may be used to specify how 
many records of the input file should be read. 


The VARIABLE or VARY entry may be used to specify tape or disk 
files having variable-length records. 


Selective printing of records can be accomplished by the 
foitowing options: 


OPTION EFFECT 
5 7 SEARCH Starts printing at the first occurrence 
: SELECT Prints only records that’ are equal 
EXCLUDE Prints only records that are not equal 
KEY Key~opér ator condition 


NOTES Only one option per specification aliowed. 


These options are further described by the following parameters: 


'€start-posn> <start-positon> denotes the starting position 
of the field where the First position in the 
record is relative position one. This numeric 
entry will specify the” byte  Cfor alpha or 
hex)» the digit (for 4&-bit)» or the bit in 
which the field begins» according to the 


BURROUGHS CORPORATION 
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<key-leng> 


<key~op> 


<search-ar g> 


search-argument position type. 


<keyriength> ts used onty with KEY option to 
specify the length of the fietd to be tested. 
The maxiaum tength is 20 Chits» digits» or 
bytes). If this option is omitted» then the 
default witit be equait to the length of the 


 €search-argument> up to 20 Cbhits» digits» or 


bytes). 


<key~oper ator> is used onty with KEY option to 
denote the type of comparison to be  perforsed 


by the KEY option and may be one of the 


foitowing: 


Operator Meaning 

GTR or > Greater 

GEQ or >= Greater than or equai 
EQL or = Equal 

LEQ or <= Less than or equat 
LSS or < Less than 

NE Q Not equal 


<search-argument> presents the data against 
which the specified fieid in the record witli 
be coapared. The type of fietd is indicated 
by the field-type specifier of the <search- 
ar gument>: | 


FIELD TYPE POSITION 


SPECIFIER TYPE DATA TYPE 

- or blank byte alphanumeric 
3 byte hexadeciaal 
a(4&) digit hexadecitnral 
ac€i)d bit binary 


The ending field-type specifier should be the 


Same as the beginning specifiers except for 
digit and bit where “2" is sufftctente 


HIG FE: EUR AAR ERA EGER ADL: P ky SNE CN Ai Fr MAREE ARR SN PSPS IAS MAR Teh Ea GH AR 
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<nus-to-return> <nusgber-tocreturn> is an integer used to ‘stop 


the selective process after the nauaber of 
records that the option specified has been 
feached. Care should be taken when using both 
the INCLUDE and <nusber-tocreturn> options 
together» as the list wilt terminate when 
either of the two options is satisfied. 


The heading for the output listing contains the file identifier» 
record ftength»s biocking factors current date» and time. In 
addition» a printout of a disk file will have the vatue of the 
end~of-file pointer in the headinge A running record count which 


indicates the record number of the tnput file tis printed in the 


leftrhand margin. 


FRAP EMA eRe RRA hn AS HAM Hah NEARER ENE WIS PM Ages AL AN 


jets Seca as i ee ee a eo ees ee aoe 
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REPRODUCTION SPECIFICATIONS 


The reproduction string consists of the specifications shown in 
table 4.1 and explained in the pages that follow. <A valid DMPALL 


command ts developed from following the main line of syntax fros 


its beginning to its termination point (#). Where optional 
entries are concerned» the direction of flow proceeds down on the 
left line and up on the right. The conventions and abbreviations 
used in this table are the same as those used in table 3el» Print 
Specification String. 


PERFORM» PFMe COPYse or CAT informs DMPALL that media conversion 
is desired. | 


vat 
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=—-m =a PERF ORS eee ee rer rr TTT TTT TTT TTT TTT S. 
| «a - / a j | 3 ; | 
I-- COPY -->1 I-~"'<routine-type> -->! 


> > ee2eneaae@ <inputfile-id> O88 O88 2S OB BHO BBBBBTBBAOBOO 88 G2 88222 2ey> 


i i 
{°-- HOST aa ae chostname> owe > } 


i-/1\-- <input-rec-Leng> SSS S SSeS SSeS sere sa SSS =>) 
: 7 l-- <blocking-factor> --->! 
{ i 
P“/1N\9" VARIABLE owestes ses ense sesame nccesesmnesnasnnssaaa> | 
i bm VARY ---->->I!I i 
l | 1 
P-/iNo> TAG? <tagrfilertid> sees mers see eee eneseeesseenn-->} 
I-/iNe* <input-file-access~mode> eerte stesso ossserseseese=>i 
b-7UN==<outout=fitle-id> “scores esss sss ss ese sess eseese=> 4 
{ | i-- HOST -- <hostname> e--c--=>! 
i | { 
t=71IN="* <outputerecsteng> =“S9s8e 4926s 24<s5eSessee2S==-44==> } 
| i-- <blocking-factor> er7ecrre->]) 
i | | i 
1 Le eeees ees SSeS Sse S err ere Sess ee2SSseSeeese2 ee =i ' 
I t= <blocks per“arée a>. “oe ss se" ess SSee"eeeesS" eee") 1 
{ l-- <number-of-areas> e7°%77">>! 
i-/i\-- <output°filecraccess~mode> sors sto seers ssssseresre=>| 
P“/1\-> VARIABLE cee ese eee coe were sess scare ses anasorense=> | 
f Im" VARY ----->] ' 
j i 
1=J1\e"" SKIP <integer> “3294 $ sss eSesee reese eses sesso =>] 
ee7i\ee= INCLUDE <stnteger> << -eteersers sees sere see“ seee"™> I 
i —<<5" | 7 i 
4 : | ‘ 
I-/i\~r" SEARCH -- Cstart-*posn> “-"° <search-arg> °cc%r777>>! 
j === | t+ @ 9 

j-- SELECT --1 ee 
boo. 1 | Kom eweceererennm--] 61 

f-- EXCLUDE <1 i-- <num~tocreturn> ->1 1 

\ own { 

Im-- KEY" <start*posn> ssetoresseerccrr-<keyrop>-i i 
i--<ckey-leng>->! i ! 
: i 

’ 
i 
i 


j-- <search~arg> Ra beh 


{-- <hus-to-return> <-->! 


Table 41 Reproduction Specification String 
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CONCATENATION OPTION 


The concatenation option copies the concatenation file on the end 
of the base file. The <routine-type> is assumed to be disk toa 
disk copy? howevers when stated» the <routine-type> must be disk 
as the base file (see Table 2.1). 


| t 
Ii-- <routinesttype > --1 


>> seen <concatenationfitle-id> SARS SERRE WEB EBB aanaedenaesy > 
f j 
i-- HOST -- <hostname> --->]1 


{-/i\~-- <concatenation-rec-leng> sae ence senses eae ee e2eoee=) j 


i i-- <blocking-factor> -->1 
tes/i\e~-e VARIABLE ee ee ee eee eS en ee 
i i-- VARY ==>} | 


be71Ne° TAGs” <€tag- tite -id> -- 9S ssser es s4 ss sees eeSese<e=s=> 
b-JiN\-- <concatenation-file-access“moder> eeeeeeeoeeceseeoe=) | 
I-/AiN\-- <baserfile ri d> crecr esse cee we ees ecewcoceeesecwn=)> { 
b-JiN\~- <base-file-access-sode> sees see reese ocsccoeees==> | 
i-/i\-- VARIABLE Sa ens eee wee ee ees ee ces wa waee aeons eeroee=)» | 
i I-- VARY =-->1 1 
. P-JINe SKIP <integer> secces sees ese ccc eens cececooseeeon=) | 
i-/i\e> INCLUDE <integer> Fs te eee aearo oe eee reese arene tercee ee ee eee 


1-/1\e77> SEARCH -- ee ee eer =os5 <search-arg> osoaee> | 
j -- } 1 | 


I-- SELECT ud i ° 44 

: i an i (Seek eSes rs rSeeesee==—='| i 
a, i-- EXCLUDE ~1 i-- <number-torreturn> ------"1 1 
: i one i 
I-- KEY -- <start-posn> SSeS er eT Te Teen 4key-ope7 tt 

im <key~ieng>->! if 

i 1 

aaa a a a a leas | 

Ao <SC at Cn ar ge So Sesser rr ee Sarre ee oleae 


i-- <nusber-to-return> -->1 


Table 4.2 Concatenation Option 


PPEDELEST Ere REGPESS PARE ES rer rer re 
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The <routine-type> entry may be either ‘in longhand or shorthand 


form. 


le 
Ze 
3e 
4. 
Se 
6. 
Te 
8. 
Pe 


10. 


11. 


The longhand fora utilizes the names of two of the 


follouing sedias 


Card files: CARD 

96-col. Card: CARD96 

Magnetic fape filles: TAPE 

Paper Tape files: PAPER . 

Disk files: DSK or DESK CAssumed if <routine-type> omitted) 
Y-Track Tape fites: TAPE7 | 


9-Track Tape fites: TAPE9 


Cassette Tape files: CASS 
Binary Card fites: BINARY 
Printer output fites: LIST 
Multicpack Disk filess MULTI 


The shorthand fora concatenates two of the following media abbre- 


viations: 


i MEDIUM | i ABBREVIATION i 


! CARD i CRD 1 


1 96-COL “CARD i C96 i 


' PAPER TAPE  f PPT i 


§ MAGNETIC TAPE i MTP i 


' O©SsK | i DSK i 


1 7-TRACK TAPE i MT7 i 


1! 9-TRACK TAPE | MT9 i 


i CASSEITE I CAS i 


{ BINARY CARD FILE 1 BIN ! 


tg . : . 
BEE OBSESSED ESE C@ OLED SS COE EC BSED WBS @©EBSE DG @ @ BS Ge 


1 PRINTER OUTPUT ft © LST 


be de ee ee ke ee Oe OY a a Ye Oe OY SE YY YY YT YS PP oe eee el helt lh 


1 MULTI-“PACK DISK 1 MPF ' 


Table 4.2 Media Abbreviation ‘able 


Example: 


Notes ae 


be 
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If <routine-type> is omitted» default is disk-to-disk. 


If SIN or BINARY is used- the last card in the 
should have “"END-OF “DECK” starting in cotuagn onee 


To go from card to magnetic tape the shorthand 
<routine-type> would’ be *CROMTP*. The lLonghand 
would be "CARD TO TAPE™ with *TO* being optional. 


file 


form 
foram 
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The forwat of the <input-file-id> is the same as used in MCP 
control instructions. Uniabeled tape files for which the user 
desires to use default values must have an <input°file-id> of 
"NONE™ Cinctuding the quotation marks). 


A hostname may be specified for either the input or output file 
or both» and indicates the direction in which files are to be 
transferred between remote and tocat hosts. 


For the concatenation options onty the concatenation fite witt 
allow hostname. if the hostname is specified» the concatenation 
fiie on the remote host wiil be appended to the base file on the 
local host. 


The <inputvreccleng> in bytes Cewaxiaurm Lengths 4000 bytes for 
ASCII conversion and TAG files and 8-000 bytes for ait other 
copies) must be the first numeric entry following the <input- 
filte-id>. If omitted» arecord tength of 80 and a blocking 
factor of one is assumed for att files except disk and labeled 
tape files which will use the record tength of the file when 
created. The <input-blocking-factor> must be the second numeric 
entry following the <inputcfile-id>. If omitted and a <rec=teng> 
entry 1s present» then an unblocked file is assumed. 


The VARIABLE or VARY entry may be used after the <input-file-id> 
entry to indicate that the input file will have variable-length 
records» but not variable-length output. - 


The TAG: <tag-fileid> entry may be used to specify the use of a 
tag file for indexing into the input fite. The tag file must be 
created with the COBOL or RPG naming conventions and never smodi- 
fied. (See the COBOL or RPG reference manual.) The user should 
be aware that the output file wilt be a sequential file ordered 
by the TAG file keys and will net match the TAG file or the input 
file. 


The <input-file-access-mode> entry may be one of the following 
Cinciuding quotation aarks): : 3 - 


le ASCII files: *"ASCII* 

2. BCL files: "BCL* 

3e BINARY files: “BINARY® 

4e EBSBCDIC files: “ESCDIC™ CIf this entry is omitted» EBCDIC 
. ~ is assumed as the default) 
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If the input file is a Labeled tape» the access mode witl be that 
with which the fitie was created. 


To change the parity of tape filles from odd to evens use the 


NCP®s FILE» or DYNAMIC or MODIFY statement. 


Exawptes 


2FILE INP.FILE EVEN 
or: ?DYNAMIC <job-nuaber> FILE INP.FILE EVEN 


The format of the <outputcfilecid> is the same as that of the 
<inputcfile-id>. If an untabeled tape file ts desired» the 
<outputcefilecrid> must be *NONE* Cincluding the quotation marks). 
Default vatues for the four numeric <output“file-id> entries are 
the following: 


<output-rec~teng> 80 
<blocking-factor > | 
<plocks“per~area> | 100 
<nuagbercofrareas> 25 


For disk or tabeled taper defauit <outputerecord-tength> Cabbre» 
<outputwrec“leng>) and <blocking-factor> is the same as those of 
the input files for disk» default <blocks~per~area> and <number- 
of~areas> wiii be those of the input file. 


if the user wishes to override the default 
<outputwrecord-tength>» he must enter the desired <output°record=- 
length>. The same ts true for <biockingsfactor>» <blocks~per- 


area>s»s and <nurgberrof~areas>. 


Entries must fotionw in sequence. Succeeding entries presume ali 
the necessary previous’ ones. For example» a <blocks-per“~area> 
entry cannot be made without both <“outputcrecord-length> and 
<biocking-factor> entries. One can» however» stop at any point 
in the sequence and the appropriate default vatues wilt be 
assumed. | 


The <output-file-access-mode> entry may be one of the foltowing 
Cincluding quotation warks): 7 . 


le ASCIE fites: "ASCII" 
2a BCL files: “BCL” 

3. BINARY files: “BINARY® 
4. EBCDIC files: "EBCDIC” 


a a pte a a a el ee eb ee a 
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If this entry is omitted» EBCDIC is assumed. 


To change the parity from odd to evens use the MCP*s FILEs 
DYNAMIC» or MODIFY statement. 


Exauptle: 


PFILE OUTP.FILE EVEN 
or: PDYNAMIC <job number> FILE OUTP.FILE EVEN 


The -VARIABLE or VARY entry» in this position Ci.e.» after the 


<output-file-id>)» indicates that both input and output records 
are variabie~tength. | | - 


The SKIP <integer> entry may be used to SKIP a specified number 
of records prior 'to creating the output file. 


The INCLUDE Cor INCL) <integer> entry may be used to specify how 
many records should be read from the input file. If the integer 
vaiue equais zero» an empty file wilt be created. 


Selective copying of records can be accomplished by the following 
: options: | 
OPTION EFFECT 
SEARCH _ Starts printing at the first occurrence 
; | | SELECT Prints only records that are equal 
EXCLUDE Prints only records that are not equal 
KEY Keywoperator condition 


NOTES Oniy one option per specification allowed. 
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These options are further described by the following parameters: 


<start-posn> _ - €startposition> denotes the starting position 
7 ‘of the field in the record where the first 
position in the record tS relative position 
one. This numeric entry wiil specify the byte 
(for alpha or hex)» the digit (for 47-bit)» or 
the bit in which the field begins» according 

to the search-argurment postion type. 


1 
Ne 


yh €keywtleng> <keyslength> is used onty with KEY option to 
| 7 specify the length of the field to be tested. — 
The maximum tength is 20 (bits» digits» or 
bytes). If this"option is omitted» then the 
default wilt be equai to the tength of the 
<search-argument> up to 20 (bits» digits» or 
bytes). 


<key7"op> <key~operator> is used only with KEY option to 
denote the type of comparison to be performed 
by the KEY option and may be _ one of the 
following: 


Oper ator Meaning 
‘GTR or > Greater 
| GEQ or >= Greater than or equal 
| | EQL or = Equal | 
! LEQ or <= Less than or equal 
| LSS or < Less than 
: NE Q ~ Not equal. 
<searcharg> <search-argumert> presents the data against 


which the specified field in the record wilt 
be compared.j The type of fieid is indicated 
by the first character€s) of the «search-ar- 
gument>: 


we 


SGA ORSON PSA AD Fy SRC TUTE lg et inh 


BURROUGHS CORPORATION COMPANY CONFEDENTIAL 


COMPUTER SYSTEMS GROUP | B1800/81700 DNPALL 
SANTA BARBARA PLANT ~P.S. 2212 5116 CH) 
| FEELD TYPE POSITION | ; 

’' §SPECIFIER TYPE DATA TYPE 

 ™ or blank byte  alphanurseric 

| a byte hexadecinat 
a(4) digit hexadecinatl 
a(1) bit binary 


The ending field-type specifier should be the 
Same as the beginning specifier» except for 
digit and bit whére "a" is sufficient. 


<num-to-return> <number-torreturn> is an integer used to stop 

| the ‘selective ‘process after the nuaber of 
records that the option specified has been 
reached. Care should be taken when using both 
the INCLUDE and <nusber-terretura> options 
together» as the tist wittl terminate when 
either of the two options is satisfied. 


SYSTEMCLOAD.DUNP TAPE DERECTORIES 


Systea/Load-edump directories can be tisted or punched with the 
following parameters: 


i <job-number>AX PD ({PUNCH] <file-identifier> 
| : 


If a System/Load.Dump directory is to be punched then the entry 
immediateiy fotlowing the PD entry must be PUNCH. if this entry 
is omitted» then a listing is assumed. The <file-identifier> 
entry is the System/Load-Dump name. 


REPLAY hl cdi yen nN eT SMR SE PSEA AN aR ZO EECA TW DAO ROMY) ete eho Re WEE RLF Ly AO 
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ERROR MESSAGES 


The following error messages are printed on the consele printer 


CQDT) 


if erroneous specifications are entered. Variables and 


comments are indicated below in lower-case. 


i. 


Ze 


8. 


Je 


10. 


11. 


12. 


13. 


<Input-file-identifier> fite NOT ON DISK 
MF.iID OR PACK.25 NUMERIC 


(The first nime found is numeric and is not surrounded 
by quotation marks.) | | 


INVALID HARDWARE TYPE OR OUTPUT FORMAT 


NUMERIC VALUE MUST FOLLOW <SKIP» INCLUDEs or SEARCH> 


. <Users~input> ITEM SHOULD NOT APPEAR BEFORE LIST OR PERFORM 


<Users~input> AREAS EXCEEDS 105 MAXIMUM 
SEARCH FIELD OUTSIDE RECORD AREA | 


CSEARCH starting position ptus length is greater than 
the input record length.) | 


ILLEGAL HDW.NANE 
MISSING OR INVALID SECOND HDW.NAME <input item> 


(The first hardware name was found» but the second 
hardware name was invatid.) : 


<user*s input> IS NOT VALID AFTER OUTPUT <file name> 
CHardware type could have been invatid or treated as an 
input-file-id or an invalid entry was found after the 
second fite name.) 


NO SPECS 


<output file> A SYSTEM DRIVE AND CANNOT BE A 
MULTI-PACK FILE. 


<input~fileridentifier> 13 A SYSTEM LOG AND CANNOT BE COPIED 
OR LISTED. | 


| 
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14. ENVALID RECORD LENGTH <recor d-tength> 
(The record length for the input or output file has 
exceeded 6» 000 bytes» or 4/000 bytes with TAG: option 
or ASCII conversions or is equal to zero.) 

iS. NO RECORDS PROCESSED--END OF FILE REACHED 
CInput file is empty or has been skipped to END.) 

16-2 EQUAL SIGN IS NOT A VALID FILE-ID 

17. <Search Argument> IS NOT A VALID KEY ARGUMENT 
(The <search-argument> has hex» digit or bit data type 
Specified and the data contains invatid characters for 
that type or the <search-argusent> is not terminated 
with an *a") 

16. PARITY ERROR - REC.NUNS <record<“nuamber > 


19.2 <Tag~-file-nama> 1/0 ERROR <recor d=number> 


20. INVALID KEY LENGTH <key-lLength> 


Mey 


C(Key-fLength given is tess than 1 or greater than 20.) 


21.2 UNVALIO KEY GPERATOR <key~operator> 


C<keycoperator> is not a valid entry. See vatid list.) 
22- [INVALID TAG FILE <tag~file-name> 


: (Tag-file-name was not created with COBOL or RPG naming 
‘ conventions) 


23. INVALID INDEX FILE <input-file-name> 
| (The index file is not a disk fite.) 
2he WARNING - <output-file"name> IS NOT AN EAD FILE 


(The input file being copied is an Installation Atlo- 
cated Disk CIAD) files but the output file is not. 


25~- INPUT ERROR: BASE FILE IS NOT A DISK FILE. 


262 INVALID PARAMETERS SPECIFIED FOR OUTPUT FILE. 
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27-2 SIZE OF INPUT WILL EXCEED OUTPUT» -CONCAT NOT 
POSSIBLE WITHOUT INCREASING SIZE OF BASE FILE. 
28. CONCATENATION ONLY ON DATA FILES ALLOWED» 
<output“file-nane> IS NOT A DATA FILE. 
292 <input“file-name> IS NOT A VARIABLE LENGTH DATA FILE. 
30. <outputcrfile-name> FILE NOT ON DISK. 
31-2 <file-name> IS TOO LONG FOR FILE“NAMNE. 
32 PACK: <Input-Pack-name> NOT FOUND. 
33~ DISK DIRECTORY READ PROBLEMS. 
34-2 MISSING HOSTNAME. 
35.2 <hostname> =: TOO LONG FOR HOST_NAME. 
CHostname specified is greater than 17 characters). 
36-4 EQUAL SIGN NOT ALLOWED IN FILE“ID FOR HOST FILES. 
(File names with "=" not atfowed on host files for 
print specification). | 
37. 


HOSTNAME NOT ALLOWED ON OUT@“FILE FOR "CAT™ OPTION. 
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EXANPLES 


The input for all the following examples is a disk file» labeled 
DSKi“and containing the following records: 


RECORD COLUNN 1 COLUMN 2-3 
01 
02 
03 


Por Oanrerse -» DS » YP 
—] 
@o 


EXAMPLE 1 


COPY DSK1 DISKi SKIP 5 INCL 5 SELECT 1A 


: The first 5 records of the disk file DSK1 will be skipped and 
: only the next 5 will be scanned. File DISKL wiil contain: 


Output Record # Image Input Record # 


i A06 6 
: | 2 AQT T 
i 3 AO9 9 


In the SELECT statement» note that the field could also have been 
specified as “A™ or aCisd or 2C€4)C1i2 of 3110000019» depending on 
the type of search argument the user desires. These variations 
are also true for the remaining examples 2 - 6. 
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EXAMPLE 2 


COPY DSK1 DASK2 SKIP 5 INCL 5 EXCLUDE 1 B 4 


The first 5 records of the disk file DSK1 will be skipped. A 
maxigum of 5 records will be scanned and a maximum of 4 records 
will be copied. Fite DISK2 wiift contain: 


Output Record # Image Input Record # 
1 A06 | 6 
2 A07 v 
3 A09 9 


Note: The INCLUDE option was exhausted first in this case. 


EXAMPLE 3 


COPY DSKi DISK3 SKIP 5S INCL 5 KEY 1 1 = A 


The first 5 records of the disk file DSKL witt be skipped» and 
only the next 5 will be scannede File DISKS wilt contain: 


Output Record # Image Input Record # 
i A06 6 
2 AO7 A 
3 AQ 9 9 


EXAMPLE 4 


LGST DSKL SKIP 5 INCL 5 SELECT 1 A 


The first 5 records of the disk file DSKL wii be skipped» and 
only the next 5 witt be scanned.j The listing will contain: | 
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Gutput Record # Image Input Record # 


1 AQ6 6 
2 AOQ7 7 
3 | A09 9 


Example 5 


LIST DSKL SKIP 5 INCL 5 EXCLUDE 1 B 4% 


The first 5 records of the disk file DSK1 will be skipped. A 
maxiaum of 5 records wilt be scanned and a wdximum of 4& records 
witt be copied. fhe listing will contain: 


Output Record # Image Input Record # 


6 AQ6 6 
f | A07 7 
9 A09 9 


Note: The INCLUDE option was exhausted first in this case. 


Examptie 6 


LIST DSKi SKIP 5S INCL 5 KEY 1 1 = 4 


The first 5 records of the disk fite DSK1 will be skipped» and 
only the next 5 widl be scanned. The Listing will contain: | 


Output Record # 7 Image Input Record # 


: 4 
BEEBE OP DS S&S 7 ab Gs ap ap 


6 A06 6 
7 A0O7 4 
9 A09 9 
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INDEX 


CARD INPUT 2-4 


CONCATENATION OPTION 4-3 
CONSOLE KEYBOARD INPUT © 2-1 


ERROR MESSAGES 5-1 

Example of Card Input 2-4 
EXAMPLES 6-1 

Examples of Consote Keyboard Input 


GENERAL DESCRIPTION 1-1 

OPERATING INSTRUCTIONS 2-1 

PRINT SPECIFICATION =: BNA HOST 3-3 
PRINT SPECIFICATION TABLE 3-3 


PRONT SPECIFICATION: EXCLUDE 375 
PRINT SPECIFICATION: HARODWARE-TYPE 


PRINT SPECIFICATION: INCLUDE 3-5 
PRINT SPECIFICATION: INPUT ACCESS MODE 


3~4 


PRINT SPECIFICATION: INPUT FILE IDENTIFIER 


PRINT SPECIFICATIGN: KEY 3°5 
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